Skip to main content
POST
Add messages [OSS + Cloud]

Authorizations

Authorization
string
header
required

API key issued by EverOS, sent as Authorization: Bearer <api_key>.

Body

application/json
session_id
string
required
Required string length: 1 - 128
messages
MessageItem · object[]
required
Required array length: 1 - 500 elements
app_id
string
default:default
project_id
string
default:default
mode
enum<string>
default:chat
Available options:
chat,
agent
async_mode
boolean
default:true

Selects the write path. true (default): validated and enqueued asynchronously → HTTP 202 with status "queued". false: forwarded synchronously to the engine, returning its 200 result and surfacing write errors directly. Extraction is always asynchronous (flush-triggered).

Response

Synchronous write result (async_mode=false).

request_id
string
required

Request trace id (peer to data)

data
AddData · object
required

Endpoint-defined business result